home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / fractals / mandelpaug / mandelpaug.doc < prev    next >
Text File  |  1994-11-17  |  34KB  |  778 lines
  1. MandelPAUG v2.1                         25 Jan 91
  2.  
  3.     An enhanced Mandelbrot and Julia set fractal generator
  4.           exclusively for the Amiga computer!
  5.  
  6. This is a fully functional implementation of the MandFXP program which was
  7. written by Bruce Dawson and Steve Larocque of CygnusSoft Software in
  8. Vancouver, B.C.  CygnusSoft Software released MandFXP as freely
  9. redistributable along with its source code.
  10.  
  11. This version was produced by Jerry D. Hedden for inclusion in the
  12. Philadelphia Amiga Users Group's (PAUG) Public Domain Software Library.
  13. Compared to previous releases, this version has the complete on-line help
  14. function, a fully implemented "Mandelbrot and Julia set movie" mode, and
  15. sports many improvements in the user-interface.  Non-visible changes include
  16. code cleanup, numerous bug fixes, better utilization of chip ram, and
  17. special code for utilizing 68020 32-bit multiplication.  The algorithmic
  18. portions of the original MandFXP source are largely unchanged.
  19.  
  20. Introduction and Theory
  21. ~~~~~~~~~~~~~~~~~~~~~~~
  22. The Mandelbrot set and the Julia set are both what is known as 'fractals'.
  23. For each pixel, a mathematical operation is performed repeatedly on its
  24. coordinates until either the result grows larger than a certain limit (two)
  25. or the operation has been performed the maximum number of times selected by
  26. the user.  This is why Mandelbrot programs take so long.  For each pixel
  27. they may have to perform the same operation hundreds of times!    If the
  28. result of the operation still hasn't exceeded two when the operation has
  29. been performed the maximum number of times, the pixel is considered to be in
  30. the Mandelbrot set (or Julia set) and is colored black.
  31.  
  32. One important thing about fractals is that they are infinitely complex.  No
  33. matter how far you zoom in, there will always be more detail farther in.  If
  34. you seem to be running out of detail, it is because the maximum number of
  35. iterations is set too low.  Raise it, and more of the details along the
  36. boundary of the set will appear.
  37.  
  38. For more information try the book 'The Fractal Geometry of Nature' by Benoit
  39. Mandelbrot [Freeman Press] (he explains it better than could be done in
  40. the limited space available here), or past issues of Scientific American.
  41.  
  42. To get a feel for why Mandelbrot images take so much time to draw, let's
  43. examine the case where the maximum iterations is set to 32 and the drawing
  44. area is 320x200 covering the full Mandelbrot set.  Generating the image will
  45. require over 1,000,000 multiplications, 1,000,000 additions, 700,000
  46. subtractions and tens of millions of other operations.    No wonder...
  47.  
  48. Outstanding Features of the MandelPAUG Program
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50. So just what does MandelPAUG have to offer?
  51.  
  52.     - Produces Mandelbrot and Julia sets in both two and three
  53.        dimensions.
  54.  
  55.     - Very fast!!  Uses custom, optimized algorithms for
  56.        computations, and features a 'remember mode' that
  57.        reduces recalculations.
  58.  
  59.     - Up to over 300 decimal places of accuracy.  Varies
  60.        with extent of zoom.
  61.  
  62.     - Full control over the number of iterations to be
  63.        performed.  Selectable color increments.
  64.  
  65.     - Full control over screen types and depth, window size,
  66.        colors, etc.
  67.  
  68.     - Images can be saved as IFF files.  Even partially
  69.        completed images can be saved, and then brought back in
  70.        for completion.
  71.  
  72.     - Full zoom in and zoom out control.  Even scrolling of
  73.        images is handled.
  74.  
  75.     - Images and specs can be saved as presets for fast recall.
  76.        An 'undo' function can be used to recall the last
  77.        image/spec.
  78.  
  79.     - Extensive on-line help!  A very user-friendly interface.
  80.  
  81.     - Mandelbrot and Julia set Movies!  Straight zoom-in or
  82.        pan while zooming.  Can be saved and loaded from disk.
  83.  
  84. Check it out and enjoy!!!
  85.  
  86. Before you run
  87. ~~~~~~~~~~~~~~
  88. MandelPAUG requires the use of req.library for its file, color and text
  89. requesters.  Therefore, you need to copy the 'req.library' file to your
  90. libs: directory.
  91.  
  92. If run from the CLI, set the stack to 8000 first.
  93.  
  94. Help
  95. ~~~~
  96. The on-line help function can be reached from the menu or by pressing the
  97. Help key.  From there, select the menu items you need information on.  When
  98. done, exit the help function by pressing the escape key.
  99.  
  100. The on-line help function is primarily designed as a quick reference.  More
  101. details on any particular function can be found in this doc file.
  102.  
  103. Documentation
  104. ~~~~~~~~~~~~~
  105. The remainder of this file contains detailed information on the functions
  106. available in the MandelPAUG program.  There is a great deal of information
  107. here.  Please take the time to read through it in order to get the maximum
  108. utility and enjoyment from the program.
  109.  
  110. The information presented below pretty much follows the order of menu item
  111. in the program.
  112.  
  113. New/Reset
  114. ~~~~~~~~~
  115. Resets the program back to the startup conditions:  full Mandelbrot set with
  116. default settings.  The user's disk-stored defaults, if found, will be used;
  117. otherwise, hardwired defaults will be set.
  118.  
  119. The file used for the disk-stored defaults can be of any type that the
  120. program handles (since they all store the default information).  However,
  121. the file must be named MandelPAUG.def.
  122.  
  123. Opening Files
  124. ~~~~~~~~~~~~~
  125. Loads in location, iterations, colors, etc. information, as well as image
  126. data (if saved).  If 'Specs Only' were stored, then the program will start
  127. calculating the picture 'from scratch'.  If saved with it's Image, it will
  128. load the image, and, if it was only a partially completed picture, will
  129. resume calculations where it had left off.
  130.  
  131. Open defaults attempts to load default settings from the file MandelPAUG.def
  132. located in the current directory.  The program then recalculates the image
  133. using these settings and the current location information.
  134.  
  135. Saving Files
  136. ~~~~~~~~~~~~
  137. Saves current program information to a file on disk.  The user is given the
  138. option of storing the Specs (settings and location information), or the
  139. Image (which includes the Specs).  The Image need not be complete, and when
  140. loaded, the program will continue calculations, if required.
  141.  
  142. The program uses IFF standards, so a saved Image will be compatible with
  143. other programs that work with IFF pictures.
  144.  
  145. Saving Defaults stores current settings (but not location information) that
  146. are used on startup, and when requested by the user.  The Defaults file
  147. will be called MandelPAUG.def.
  148.  
  149. IFF Files
  150. ~~~~~~~~~
  151. The files that MandelPAUG stores are readable by paint programs, picture
  152. viewing programs, and anything else that handles IFF files.  The extra data
  153. that MandelPAUG puts in the file will just be ignored by other programs.
  154. However, if you modify a MandelPAUG file with some other program (a paint
  155. program, for instance), don't try to load it back into MandelPAUG, as all
  156. the extra data that MandelPAUG requires will have been stripped away.
  157.  
  158. Read/Write Errors
  159. ~~~~~~~~~~~~~~~~~
  160. If something funky happens while reading or writing a file, you'll probably
  161. get an error message.  The message will probably refer to the specific IFF
  162. chunk or program variable that couldn't be dealt with.  The information may
  163. not be of much use other than to let you know that the file is probably
  164. unusable.  It could be indicative of a bug, but most likely it'll be a
  165. problem with the disk media.
  166.  
  167. Printing
  168. ~~~~~~~~
  169. Obviously, these options require the use of a printer.
  170.  
  171. Specs - Prints out current location and setting information.
  172.  
  173. Image (Sync) - This prints out the image with the program being tied-up until
  174. the printing is done.
  175.  
  176. Image (ASync) - As above, except spawns a separate task for the print job
  177. that multitasks with MandelPAUG.
  178.  
  179. You might want to play with the colors a bit before printing, especially
  180. turning the black of the set to white to save on ribbon usage.
  181.  
  182. Title Bar
  183. ~~~~~~~~~
  184. The screens title bar can be toggled on and off.
  185.  
  186. Window Size
  187. ~~~~~~~~~~~
  188. Allows the user to select the size of the drawing area.  The drawing area is
  189. always centered in the middle of the screen.  A new image is generated in
  190. the new window using the previous location information.  If the new window's
  191. shape is very different, the resulting image will be distorted.  Use Restore
  192. Aspect in the Zoom submenus to correct this, if desired.
  193.  
  194. Display Type
  195. ~~~~~~~~~~~~
  196. You can choose betwee